<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkInfoBar</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="GTK+ 3 参考手册">
<link rel="up" href="DisplayWidgets.html" title="显示构件">
<link rel="prev" href="gtk3-GtkStatusbar.html" title="GtkStatusbar">
<link rel="next" href="gtk3-GtkStatusIcon.html" title="GtkStatusIcon">
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="gtk3-GtkStatusbar.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="DisplayWidgets.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ 3 参考手册</th>
<td><a accesskey="n" href="gtk3-GtkStatusIcon.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#gtk3-GtkInfoBar.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#gtk3-GtkInfoBar.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry">
<a name="gtk3-GtkInfoBar"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="gtk3-GtkInfoBar.top_of_page"></a>GtkInfoBar</span></h2>
<p>GtkInfoBar — Report important messages to the user</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="gtk3-GtkInfoBar.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#include &lt;gtk/gtk.h&gt;

struct              <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar">GtkInfoBar</a>;
<a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="gtk3-GtkInfoBar.html#gtk-info-bar-new" title="gtk_info_bar_new ()">gtk_info_bar_new</a>                    (<em class="parameter"><code><span class="type">void</span></code></em>);
<a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="gtk3-GtkInfoBar.html#gtk-info-bar-new-with-buttons" title="gtk_info_bar_new_with_buttons ()">gtk_info_bar_new_with_buttons</a>       (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_button_text</code></em>,
                                                         <em class="parameter"><code>...</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkInfoBar.html#gtk-info-bar-add-action-widget" title="gtk_info_bar_add_action_widget ()">gtk_info_bar_add_action_widget</a>      (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>);
<a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="gtk3-GtkInfoBar.html#gtk-info-bar-add-button" title="gtk_info_bar_add_button ()">gtk_info_bar_add_button</a>             (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *button_text</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkInfoBar.html#gtk-info-bar-add-buttons" title="gtk_info_bar_add_buttons ()">gtk_info_bar_add_buttons</a>            (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_button_text</code></em>,
                                                         <em class="parameter"><code>...</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkInfoBar.html#gtk-info-bar-set-response-sensitive" title="gtk_info_bar_set_response_sensitive ()">gtk_info_bar_set_response_sensitive</a> (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkInfoBar.html#gtk-info-bar-set-default-response" title="gtk_info_bar_set_default_response ()">gtk_info_bar_set_default_response</a>   (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkInfoBar.html#gtk-info-bar-response" title="gtk_info_bar_response ()">gtk_info_bar_response</a>               (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkInfoBar.html#gtk-info-bar-set-message-type" title="gtk_info_bar_set_message_type ()">gtk_info_bar_set_message_type</a>       (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType"><span class="type">GtkMessageType</span></a> message_type</code></em>);
<a class="link" href="gtk3-GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType"><span class="returnvalue">GtkMessageType</span></a>      <a class="link" href="gtk3-GtkInfoBar.html#gtk-info-bar-get-message-type" title="gtk_info_bar_get_message_type ()">gtk_info_bar_get_message_type</a>       (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>);
<a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="gtk3-GtkInfoBar.html#gtk-info-bar-get-action-area" title="gtk_info_bar_get_action_area ()">gtk_info_bar_get_action_area</a>        (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>);
<a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="gtk3-GtkInfoBar.html#gtk-info-bar-get-content-area" title="gtk_info_bar_get_content_area ()">gtk_info_bar_get_content_area</a>       (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>);
</pre>
</div>
<div class="refsect1">
<a name="gtk3-GtkInfoBar.description"></a><h2>Description</h2>
<p>
<a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> is a widget that can be used to show messages to
the user without showing a dialog. It is often temporarily shown
at the top or bottom of a document. In contrast to <a class="link" href="gtk3-GtkDialog.html#GtkDialog" title="struct GtkDialog"><span class="type">GtkDialog</span></a>, which
has a horizontal action area at the bottom, <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> has a
vertical action area at the side.
</p>
<p>
The API of <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> is very similar to <a class="link" href="gtk3-GtkDialog.html#GtkDialog" title="struct GtkDialog"><span class="type">GtkDialog</span></a>, allowing you
to add buttons to the action area with <a class="link" href="gtk3-GtkInfoBar.html#gtk-info-bar-add-button" title="gtk_info_bar_add_button ()"><code class="function">gtk_info_bar_add_button()</code></a> or
<a class="link" href="gtk3-GtkInfoBar.html#gtk-info-bar-new-with-buttons" title="gtk_info_bar_new_with_buttons ()"><code class="function">gtk_info_bar_new_with_buttons()</code></a>. The sensitivity of action widgets
can be controlled with <a class="link" href="gtk3-GtkInfoBar.html#gtk-info-bar-set-response-sensitive" title="gtk_info_bar_set_response_sensitive ()"><code class="function">gtk_info_bar_set_response_sensitive()</code></a>.
To add widgets to the main content area of a <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a>, use
<a class="link" href="gtk3-GtkInfoBar.html#gtk-info-bar-get-content-area" title="gtk_info_bar_get_content_area ()"><code class="function">gtk_info_bar_get_content_area()</code></a> and add your widgets to the container.
</p>
<p>
Similar to <a class="link" href="gtk3-GtkMessageDialog.html#GtkMessageDialog" title="struct GtkMessageDialog"><span class="type">GtkMessageDialog</span></a>, the contents of a <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> can by
classified as error message, warning, informational message, etc,
by using <a class="link" href="gtk3-GtkInfoBar.html#gtk-info-bar-set-message-type" title="gtk_info_bar_set_message_type ()"><code class="function">gtk_info_bar_set_message_type()</code></a>. GTK+ uses the message type
to determine the background color of the message area.
</p>
<p>
</p>
<div class="example">
<a name="id3136388"></a><p class="title"><b>Example 50. Simple GtkInfoBar usage.</b></p>
<div class="example-contents"><pre class="programlisting">
/* set up info bar */
info_bar = gtk_info_bar_new ();
gtk_widget_set_no_show_all (info_bar, TRUE);
message_label = gtk_label_new ("");
gtk_widget_show (message_label);
content_area = gtk_info_bar_get_content_area (GTK_INFO_BAR (info_bar));
gtk_container_add (GTK_CONTAINER (content_area), message_label);
gtk_info_bar_add_button (GTK_INFO_BAR (info_bar),
                         GTK_STOCK_OK, GTK_RESPONSE_OK);
g_signal_connect (info_bar, "response",
                  G_CALLBACK (gtk_widget_hide), NULL);
gtk_table_attach (GTK_TABLE (table),
                  info_bar,
                  0, 1, 2, 3,
                  GTK_EXPAND | GTK_FILL,  0,
                  0,                      0);

/* ... */

/* show an error message */
gtk_label_set_text (GTK_LABEL (message_label), error_message);
gtk_info_bar_set_message_type (GTK_INFO_BAR (info_bar),
                               GTK_MESSAGE_ERROR);
gtk_widget_show (info_bar);
</pre></div>
</div>
<p><br class="example-break">
</p>
<p>
</p>
<div class="refsect2">
<a name="GtkInfoBar-BUILDER-UI"></a><h3>GtkInfoBar as GtkBuildable</h3>
<p>
The GtkInfoBar implementation of the GtkBuildable interface exposes
the content area and action area as internal children with the names
"content_area" and "action_area".
</p>
<p>
GtkInfoBar supports a custom &lt;action-widgets&gt; element, which
can contain multiple &lt;action-widget&gt; elements. The "response"
attribute specifies a numeric response, and the content of the element
is the id of widget (which should be a child of the dialogs <em class="parameter"><code>action_area</code></em>).
</p>
</div>
<p>
</p>
</div>
<div class="refsect1">
<a name="gtk3-GtkInfoBar.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="GtkInfoBar"></a><h3>struct GtkInfoBar</h3>
<pre class="programlisting">struct GtkInfoBar {
  GtkHBox parent;
};
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-info-bar-new"></a><h3>gtk_info_bar_new ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_info_bar_new                    (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>
Creates a new <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> object.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>a new <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> object</td>
</tr></tbody>
</table></div>
<p class="since">Since 2.18</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-info-bar-new-with-buttons"></a><h3>gtk_info_bar_new_with_buttons ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_info_bar_new_with_buttons       (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_button_text</code></em>,
                                                         <em class="parameter"><code>...</code></em>);</pre>
<p>
Creates a new <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> with buttons. Button text/response ID
pairs should be listed, with a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> pointer ending the list.
Button text can be either a stock ID such as <a class="link" href="gtk3-Stock-Items.html#GTK-STOCK-OK:CAPS" title="GTK_STOCK_OK"><code class="literal">GTK_STOCK_OK</code></a>, or
some arbitrary text. A response ID can be any positive number,
or one of the values in the <a class="link" href="gtk3-GtkDialog.html#GtkResponseType" title="enum GtkResponseType"><span class="type">GtkResponseType</span></a> enumeration. If the
user clicks one of these dialog buttons, GtkInfoBar will emit
the "response" signal with the corresponding response ID.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>first_button_text</code></em> :</span></p></td>
<td>stock ID or text to go in first button, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
<td>response ID for first button, then additional buttons, ending
with <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>a new <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-info-bar-add-action-widget"></a><h3>gtk_info_bar_add_action_widget ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_info_bar_add_action_widget      (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>);</pre>
<p>
Add an activatable widget to the action area of a <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a>,
connecting a signal handler that will emit the <span class="type">"response"</span>
signal on the message area when the widget is activated. The widget
is appended to the end of the message areas action area.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info_bar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
<td>an activatable widget</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>response_id</code></em> :</span></p></td>
<td>response ID for <em class="parameter"><code>child</code></em>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.18</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-info-bar-add-button"></a><h3>gtk_info_bar_add_button ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_info_bar_add_button             (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *button_text</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>);</pre>
<p>
Adds a button with the given text (or a stock button, if button_text
is a stock ID) and sets things up so that clicking the button will emit
the "response" signal with the given response_id. The button is appended
to the end of the info bars's action area. The button widget is
returned, but usually you don't need it.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info_bar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>button_text</code></em> :</span></p></td>
<td>text of button, or stock ID</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>response_id</code></em> :</span></p></td>
<td>response ID for the button</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the <a class="link" href="gtk3-GtkButton.html#GtkButton" title="struct GtkButton"><span class="type">GtkButton</span></a> widget that was added. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.18</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-info-bar-add-buttons"></a><h3>gtk_info_bar_add_buttons ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_info_bar_add_buttons            (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_button_text</code></em>,
                                                         <em class="parameter"><code>...</code></em>);</pre>
<p>
Adds more buttons, same as calling <a class="link" href="gtk3-GtkInfoBar.html#gtk-info-bar-add-button" title="gtk_info_bar_add_button ()"><code class="function">gtk_info_bar_add_button()</code></a>
repeatedly. The variable argument list should be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated
as with <a class="link" href="gtk3-GtkInfoBar.html#gtk-info-bar-new-with-buttons" title="gtk_info_bar_new_with_buttons ()"><code class="function">gtk_info_bar_new_with_buttons()</code></a>. Each button must have both
text and response ID.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info_bar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>first_button_text</code></em> :</span></p></td>
<td>button text or stock ID</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
<td>response ID for first button, then more text-response_id pairs,
ending with <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.18</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-info-bar-set-response-sensitive"></a><h3>gtk_info_bar_set_response_sensitive ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_info_bar_set_response_sensitive (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);</pre>
<p>
Calls gtk_widget_set_sensitive (widget, setting) for each
widget in the info bars's action area with the given response_id.
A convenient way to sensitize/desensitize dialog buttons.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info_bar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>response_id</code></em> :</span></p></td>
<td>a response ID</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td>
<td>TRUE for sensitive</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.18</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-info-bar-set-default-response"></a><h3>gtk_info_bar_set_default_response ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_info_bar_set_default_response   (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>);</pre>
<p>
Sets the last widget in the info bar's action area with
the given response_id as the default widget for the dialog.
Pressing "Enter" normally activates the default widget.
</p>
<p>
Note that this function currently requires <em class="parameter"><code>info_bar</code></em> to
be added to a widget hierarchy.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info_bar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>response_id</code></em> :</span></p></td>
<td>a response ID</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.18</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-info-bar-response"></a><h3>gtk_info_bar_response ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_info_bar_response               (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>);</pre>
<p>
Emits the 'response' signal with the given <em class="parameter"><code>response_id</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info_bar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>response_id</code></em> :</span></p></td>
<td>a response ID</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.18</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-info-bar-set-message-type"></a><h3>gtk_info_bar_set_message_type ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_info_bar_set_message_type       (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType"><span class="type">GtkMessageType</span></a> message_type</code></em>);</pre>
<p>
Sets the message type of the message area.
GTK+ uses this type to determine what color to use
when drawing the message area.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info_bar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>message_type</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType"><span class="type">GtkMessageType</span></a>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.18</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-info-bar-get-message-type"></a><h3>gtk_info_bar_get_message_type ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType"><span class="returnvalue">GtkMessageType</span></a>      gtk_info_bar_get_message_type       (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>);</pre>
<p>
Returns the message type of the message area.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info_bar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the message type of the message area.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.18</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-info-bar-get-action-area"></a><h3>gtk_info_bar_get_action_area ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_info_bar_get_action_area        (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>);</pre>
<p>
Returns the action area of <em class="parameter"><code>info_bar</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info_bar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the action area. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.18</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-info-bar-get-content-area"></a><h3>gtk_info_bar_get_content_area ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_info_bar_get_content_area       (<em class="parameter"><code><a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a> *info_bar</code></em>);</pre>
<p>
Returns the content area of <em class="parameter"><code>info_bar</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info_bar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkInfoBar.html#GtkInfoBar" title="struct GtkInfoBar"><span class="type">GtkInfoBar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the content area. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.18</p>
</div>
</div>
<div class="refsect1">
<a name="gtk3-GtkInfoBar.see-also"></a><h2>See Also</h2>
<a class="link" href="gtk3-GtkStatusbar.html#GtkStatusbar" title="struct GtkStatusbar"><span class="type">GtkStatusbar</span></a>, <a class="link" href="gtk3-GtkMessageDialog.html#GtkMessageDialog" title="struct GtkMessageDialog"><span class="type">GtkMessageDialog</span></a>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.18</div>
</body>
</html>